Proposed by Nikos Kouremenos
https://bugzilla.gnome.org/show_bug.cgi?id=321958
/**
* gtk_calendar_get_date:
* @calendar: a #GtkCalendar
- * @year: (allow-none): location to store the year number, or %NULL
+ * @year: (allow-none): location to store the year as a decimal number (e.g. 2011), or %NULL
* @month: (allow-none): location to store the month number (between 0 and 11), or %NULL
* @day: (allow-none): location to store the day number (between 1 and 31), or %NULL
- *
+ *
* Obtains the selected date from a #GtkCalendar.
- **/
+ */
void
gtk_calendar_get_date (GtkCalendar *calendar,
guint *year,